[% setvar title Add change bar functionality to pod %]
<div id="archive-notice">
    <h3>This file is part of the Perl 6 Archive</h3>
    <p>To see what is currently happening visit <a href="http://www.perl6.org/">http://www.perl6.org/</a></p>
</div>
<div class='pod'>
<a name='TITLE'></a><h1>TITLE</h1>
<p>Add change bar functionality to pod</p>
<a name='VERSION'></a><h1>VERSION</h1>
<pre>  Maintainer: Dan Sugalski &lt;<a href='mailto:dan@sidhe.org'>dan@sidhe.org</a>&gt;
  Date: 8 Aug 2000
  Mailing List: <a href='mailto:perl6-language@perl.org'>perl6-language@perl.org</a>
  Number: 65
  Version: 1
  Status: Developing</pre>
<a name='ABSTRACT'></a><h1>ABSTRACT</h1>
<p>Documents change, and change bars are a nice way to indicate what's
changed. This RFC suggests a way to indicate the changed parts of a
document that POD2whatever translators can mark appropriately. The
change bars should also be distinct to the reader of the raw POD.</p>
<a name='DESCRIPTION'></a><h1>DESCRIPTION</h1>
<p>Making what's changed in documentation stand out's quite useful,
something I'm coming to appreciate more and more as the RFCs are
flying back and forth. The standard way to do this is to mark the
changed sections with one or more vertical bars on the left margin.</p>
<p>Since changes can themselves be changed, multiple levels of change bar
can occur. This mirrors the common practice in printed documentation.</p>
<a name='IMPLEMENTATION'></a><h1>IMPLEMENTATION</h1>
<p>The pod parser modules look for the sequence /^|+\s/ at the beginning
of a line and, if it's there, that line is considered as changed. The
number of bars in front of a line indicates the number of bars in
front of the text in the formatted output.</p>
<p>If, when outputtiing a line, there is any changed text in it, then the
entire line is marked as changed. So, for example, if the POD looked
like:</p>
<pre>   this
   is
   | a
   line</pre>
<p>the output would be:</p>
<pre>  | this is a line</pre>
<p>since at least one character on the formatted version was changed.</p>
<a name='REFERENCES'></a><h1>REFERENCES</h1>
<p>Every piece of good documentation for version 1.1 or higher of something.</p>
</div>
